Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Sep 4, 2025

Teachers at Mergington High School were uncomfortable modifying the system directly and unsure how to write clear issue descriptions for change requests. This PR introduces a comprehensive set of GitHub issue templates that guide teachers through structured forms, ensuring Copilot coding agents receive complete context for efficient implementation.

What's Added

📋 Six Specialized Issue Templates

  1. 🎯 Adicionar Nova Atividade - For creating new extracurricular activities with complete details (name, description, schedule, participant limits, etc.)

  2. ✏️ Modificar Atividade Existente - For modifying existing activities with before/after comparisons and impact assessment

  3. 👥 Gerenciar Inscrições de Alunos - For student registration management (manual enrollment, removal, transfers, capacity changes)

  4. 🐛 Relatar Problema no Sistema - For comprehensive bug reports with reproduction steps, environment details, and urgency levels

  5. 🚀 Nova Funcionalidade - For feature requests with detailed requirements, use cases, and implementation considerations

  6. 📅 Modificar Horários e Agendas - For schedule modifications with conflict detection and student impact analysis

🔧 Technical Integration

Each template includes:

  • Clear acceptance criteria for validation
  • Specific file references to the Clean Architecture codebase (ActivityUseCase.java, Activity.java, etc.)
  • Implementation guidance following established patterns (entity validation, use case orchestration, etc.)
  • Testing considerations for affected functionality

📚 Teacher Documentation

Added docs/GUIA_PROFESSORES.md with:

  • Step-by-step usage instructions
  • Practical examples for each template type
  • Best practices for filling out forms
  • Contact information for urgent support

⚙️ Template Configuration

  • config.yml organizes template selection and disables blank issues
  • Templates use Portuguese to match the existing application interface
  • Proper labeling and categorization for automated processing

Example Usage

When a teacher wants to create a new robotics club, they simply select the "Adicionar Nova Atividade" template and fill in structured fields like:

Nome: Clube de Robótica
Descrição: Atividade para alunos interessados em programação e montagem de robôs
Categoria: ☑️ Tecnologia
Dias da semana: Terça e Quinta
Horário: 15:00 às 16:30
Limite: 15 alunos

The template ensures all necessary information is captured, including technical context about which files need modification (Activity.java, V001_InitialDatabaseSetup.java) and validation patterns to follow.

Benefits

  • ⚡ Faster processing - No back-and-forth for missing information
  • 🎯 Better accuracy - Structured input reduces misunderstandings
  • 🤖 AI-ready - Complete context enables autonomous implementation
  • 📈 Teacher productivity - No need to learn technical issue writing

Fixes #5.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: juliannaPaz <90342866+juliannaPaz@users.noreply.github.com>
@Copilot Copilot AI changed the title [WIP] Simplifique solicitações de mudança para professores Create GitHub issue templates to simplify teacher change requests Sep 4, 2025
@Copilot Copilot AI requested a review from juliannaPaz September 4, 2025 13:35
Copilot finished work on behalf of juliannaPaz September 4, 2025 13:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Simplifique solicitações de mudança para professores

2 participants